{QUAD-Plot was designed with ease of use foremost in mind. Many of the current plotting packages make preparing a simple graph a laborious process. In QUAD-Plot a high quality graph can be produced by simply dragging a text file over the QUAD-Plot icon and selecting GO! from the PLOT menu!
Frequently in science one produces an ASCII data file and would like to plot one or more pairs of columns against each other or perhaps compare this data with the results of a previous calculation. One does not want to spend minutes first importing the data file and yet more minutes trying to adjust the plot characteristics so that the result doesn't look clunky and primitive or, worse still, misleading.
In QUAD-Plot we tried to produce a friendly and fast means of viewing and printing plots of scientific data.
If you have any suggestions or comments, or if you find any bugs, then please contact Robin Harmon either by EMAIL at harmon@wfpc3.la.asu.edu or by regular mail at the registration address. Queries by regular mail will take 14 days or more to be answered (due to forwarding delays).}
\subTitle{Aims}
{• Simple importation of SPACE or TAB separated text files.
• Import and view datasets of size limited by computer memory only.
• Intelligent default values for plot characteristics.
• Fast plotting of data, either XY-pairs or histograms.
• Convenience in viewing multiple plots on one screen.
• Easy and intuitive selection and modification of individual datasets on a plot.
• Ease in producing a printed copy of a plot.
}
\subTitle{Features}
{Importation of data:
------------------
1. SPACE or TAB separated files imported either by drag-and-drop or via. a standard file dialog.
2. The limit on the size of file is set by the available memory.
3. Files may contain comments, preceded by a percent sign. They may also contain blank lines.
4. PC or Mac text files imported with no fuss.
Plotting Graphs:
--------------
1. Columns to be plotted are selected on menus.
2. Data can be drawn as (x,y) pairs or binned and drawn as a histogram.
3. Symbols can be chosen from a pallet of 25.
4. A range of line styles may be used to connect the data.
5. Lines and symbols can have one of eight colors.
6. Data can have error-bars easily attatched and modified.
Viewing Graphs:
---------------
1. Intelligent defaults are used to ensure that a plot is immediately of good quality.
2. Windows can be re-sized and their plot re-sizes automatically to enable many windows to be viewed at once on the screen.
Editing Graphs:
--------------
1. A dataset can be easily selected by clicking next to one of its points (or bins).
2. Cutting and pasting datasets is like working with text in a word-processor.
3. A dataset can be easily cut from one window and pasted into another.
Printing Graphs:
---------------
1. Plots may easily be printed on a page.
2. Hairlines can be used to take advantage of the high resolution of a printer.
Exporting Graphs and Data:
-------------------------
1. Plots can be exported as PICTs.
2. The resolution of a PICT can be kept high for quality printing when included in another document.
3. Individual datasets may be exported as text files.
Speed:
------
1. QUAD-Plot is faster than most other commercial packages at importing and plotting data.
Help:
-----
1. A convenient on-line help system can be read while you use the application.
REQUIREMENTS.
--------------
QUAD-Plot will work on any Mac running System 7.0 or later with at least 768 kilobytes of free memory. The default memory allocation allows up to about 50,000 points to be plotted.
}
\title{Registration}
{DISTRIBUTION.
-------------
The QUAD-Plot application is SHAREWARE. If you decide that you like it please send the shareware fee to the addresse below. The unregistered version of the program may be distributed freely provided it is unaltered and distributed complete with any associated files.
REGISTRATION.
--------------
The unregistered version of QUAD-Plot is a useful program, allowing the visualization and printing of data. Plots can be exported as a PICT file and incorporated into other programs such as one of the popular word-processers.
The "Save" and "Save As" features are, however, disabled. Payment of the shareware fee will unlock these menu options. It will also allow registered users to download and access all the features of minor upgrade versions of QUAD-Plot ie. versions 1.x. The next major version upgrade will be available at a discount to registered users.
In order to register please send $20 in the form of a check, cash or money order to this address:
Robin Harmon
c/o Alan Murray
3029 Creekview Drive
TX 76051
U.S.A.
Make checks payable to Robin Harmon. Please include a CLEARLY writen name to whoom the software is to be registered .
MULTIPLE COPIES.
----------------
Each registration fee entitles you to use one copy of QUAD-Plot at a time. If you wish to use more then you must pay for each additional copy. If, however, you order more than 5 copies then the additional ones cost just $10.
NO WARRANTY.
--------------
THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY; WITHOUT EVEN THE WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
}
\title{A Quick Plot}
{To Create A Plot:
----------------
1. Drag a text file icon over the QUAD-Plot icon. This will import the text file.
2. Select "Go!" on the Plot menu (Command G). This will cause the second column to be plotted against the first in the default symbol and without lines joining the points.
To Modify A Plot:
----------------
1. Click in the plot window near a point of the dataset you wish to modify. This will select that dataset.
2. Change the dataset characteristics reflected on the menus.
3. Click outside the plot border to remove selection of this dataset or click near another dataset to select it.
To Print A Plot:
--------------
1. Check "Page Setup" on the Files menu. Is the correct printer selected?
2. Check "Resolution/Size" on the Files menu. Is the plot size OK? Are you happy with the line-widths to be used?
3. Select "Print" on the Files menu.
To Save A Plot:
--------------
1. Select "Save As" on the files menu.
}
\title{FILES}
{The Files menu deals with the input and output of QUAD-Plot files, import and export of data, the printing of QUAD-Plot windows/files and exiting the application.
}
\subTitle{New} {Opens an empty window for subsequent plotting operations. }
\subTitle{Open} {Opens an existing QUAD-Plot file. }
\subTitle{Close} {Closes the frontmost window, prompting if it may need to be saved first. }
\subTitle{Save} {Saves the frontmost window. }
\subTitle{Save As} {Saves the frontmost window under a new name. }
\subTitle{Import}
{Prompts for the name of a file to import.
QUAD-Plot can import a text file of data with columns separated by space(s) or TAB(s).
• Any text following a percent sign is treated as a comment and ignored.
• Blank lines are ignored.
• PC generated text files are read without problem.
• Each row of data in the file should contain the same number of columns.
• The maximum line length is 512 characters.
Memory.
--------
The default allocation for QUAD-Plot is 768Kb. This will allow you to plot up to about 50,000 points in your windows. If you would like to work with larger datasets then increase the memory allocation by about 250Kb per 20,000 points to be plotted. You can do this by selecting the QUAD-Plot icon in the Finder and opening the Information option on the Files menu. Change the Prefered size and close the information panel.
}
\subTitle{Release File}
{QUAD-Plot will keep an imported file open until another is imported.
If you would like to edit the currently imported file using another program then you must first release it with this menu option (or import another file).}
\subTitle{Export}
{This menu has two options:
• Export Dataset. This option will export a selected dataset as a file of text separated by spaces.
• Export Plot as PICT. The entire plot will be written out as a PICT file. A dialog prompts for a scale factor to be applied to the resolution of the plot before writting it out. This is used to produce an image with higher resolution to be included in a document to be printed.
}
\subTitle{Resolution/Size}
{Allows the size of the printed plot on a page and the thickness of its lines to be set.
• There are 3 possible choices of plot size and position on a page.:
- As on screen. The plot is printed at the same size as it appears on the screen, at the corner of the page.
- As in the zoomed-out view. The prefered width for the zoomed view is 7 inches and an aspect ratio of 2/3.
- Fill the page. The plot is scaled to fill the currently selected page size.
• The resolution of almost any printer is higher than that of a VDU and one would like to produce plots which take advantage of this. QUAD-Plot allows the user to set the width of the graph border and the lines attatched to data within the plot independently. The units of thickness are those of a pixel on the printer.
}
\subTitle{Page Setup} {Selects the general page features for printing.}
\subTitle{Print} {Sets the details of the printing job.}
\subTitle{Save Preferences} {Saves the current settings of QUAD-Plot.}
\subTitle{Quit} {Leaves the application QUAD-Plot.}
\title{EDIT}
{Datasets can be cut, copied or cleared from any window and pasted into any other.
Some of these operations are reversible and the first item in the menu will indicate if this is so.
Addition or removal of any dataset from a window will cause the ranges to be automatically adjusted to best display the window contents if the "Default" option is chosen on the ranges menu.
In addition to operations involving individual datasets, the entire plot can be copied as a PICT to the clipboard.
The hilite state can be changed so that only one point of a dataset is hilited when a dataset is selected.}
\subTitle{Undo} {Reverses the effects of the last editing operation (Cut or Paste) or last "Go".}
\subTitle{Cut} {Deletes the currently selected dataset and copies it to the copy buffer.}
\subTitle{Copy} {Copies the currently selected dataset to the copy buffer.}
\subTitle{Paste} {Pastes the currently copied dataset into the frontmost window.}
\subTitle{Clear} {Deletes the selected dataset.}
\subTitle{Copy Plot} {Copies the entire plot to the clipboard.}
\subTitle{Hilite All Points} {All data are hilited when you select a dataset in a plot window.}
\subTitle{Hilite One Point} {Only the datum nearest the cursor is hilited when you select a dataset.
This is preferable if you are dealing with datasets of more than say 1000 points.}
\title{LABELS} {The labels on the frontmost plot and their characteristics can be adjusted through this menu.}
\subTitle{None} {No labels will be displayed on the current plot.}
\subTitle{Default} {The labels on the current plot will refer to the last file from which data was chosen.
• The title is set to the name of the file.
• In XY-Plot mode the X and Y labels reflect the column numbers of the last dataset added.
• In Histogram mode the X label reflects the last column that was binned onto the plot and the Y label is set to the letter "N".
}
\subTitle{User Defined} {The labels are set to those defined by you in the "Set User..." menu item.}
\subTitle{Set User}
{Presents a dialog in which you can enter strings for the X and Y labels and the plot title. In the dialog there are 2 buttons in addition to Cancel and OK.
• Defaults - copies of the default labels are written into the editable areas.
• Use - QUAD-Plot will switch to the "User" option on exiting the dialog.
}
\subTitle{Font} {Permits selection of the font to be used for the X and Y labels and the plot title.}
\subTitle{Size} {Permits selection of the font size to be used for the X and Y labels and the plot title.}
\subTitle{Style} {Permits selection of the font style to be used for the X and Y labels and the plot title.}
\subTitle{Scale/Don't Scale}
{One of the convenient features of QUAD-Plot is that you can change the size of a window and its contents are scaled to the new size. This allows you to shrink your windows and view several of them on the screen at the same time without overlap. The full contents of each are visible albeit at a reduced size.
The Scale/Don't Scale option affects the labels on the plot. If you choose "Scale" then the labels are scaled in size so that only in the zoomed-out view do they have the size you set in the "Size" sub-menu. If you choose "Don't Scale" then they are displayed at your selected size regardless of the window size.}
\title{RANGES} {The coordinate ranges displayed on the frontmost plot can be adjusted through this menu. }
\subTitle{Default} {The X and Y ranges on the current plot are set to be 10% larger than the absolute range of the data in the window.}
\subTitle{User Defined} {The coordinate ranges used to display the data are those defined by you in the "Set User..." menu item.
If none have been set then they default to the interval from -1 to +1 in X and Y.}
\subTitle{Set User}
{Presents a dialog in which you can enter coordinate ranges in X and Y. The OK button is disabled if the current ranges are not readable. There are 2 buttons in the dialog in addition to Cancel and OK.
• Defaults - copies of the default ranges are written into the editable areas.
• Use - QUAD-Plot will switch to the "User" option on exiting the dialog.
}
\subTitle{Draw X-axis} {A coordinate axis will be drawn at Y = 0. Tick marks are drawn at the same positions as on the graph border.}
\subTitle{Draw Y-axis} {A coordinate axis will be drawn at X = 0. Tick marks are drawn at the same positions as on the graph border.}
\subTitle{Justify/Don't Justify}
{
• Justify - equal coordinate intervals along the X and Y axes will have equal lengths on the screen (or page).
• Don't Justify - the coordinate scales in X and Y will be chosen to fill the window and hence will be unequal in general.
}
\title{SYMBOLS} {The choice of symbol to be assigned to the next plotted dataset (or the currently selected one) is made using this menu. The symbol characteristics which may be set are size, color and whether or not it is scaled with the window size.}
\subTitle{None} {A convenient way of turning off symbols for the next dataset to be plotted or the currently selected one.}
\subTitle{Default} {Sets the symbol choice to be the next-to-smallest point which corresponds to the second symbol on the pallet.}
\subTitle{Pallet} {You may choose any symbol from this pallet.}
\subTitle{Size} {The size of the symbols attatched to the next dataset or the currently selected one are set here.}
\subTitle{Color} {The color of the symbols attatched to the next dataset or the currently selected one are set here.
On a black and white monitor the color blocks beside each option are all white. You may still change the symbols' color so that when the plot is displayed on a color machine it is displayed in your chosen color.}
\subTitle{Scale/Don't Scale}
{This option is identical to that for the Labels around the plot border. The size of a symbol may be scaled with the window size for convenient viewing of many windows on one screen or you can insist that it have the size you choose at all window sizes.}
\title{LINES} {The points in a dataset may be joined with a line drawn in one of a range of styles, widths and colors. The characteristics set on this menu will be assigned to the next plotted dataset (or the currently selected one).}
\subTitle{None} {A convenient way of turning off lines for the next dataset to be plotted or the currently selected one.}
\subTitle{Style} {Sets the line-style to be applied to the next dataset plotted or the currently selected one.}
\subTitle{Width} {You may draw the line in any width. The Resolution/Size menu option on the Files menu will determine the thickness of these lines on a page.}
\subTitle{Color} {The color of the line joining the points of the next dataset or the currently selected one is set here.
On a black and white monitor the color blocks beside each option are all white. You may still change the lines' color so that when the plot is displayed on a color machine it is displayed in your chosen color.}
\title{COLUMN(S)} {When a data file is Imported the Column menus change to reflect the number of columns in the file. The choice of which column to plot against which is made here. }
\subTitle{Errors}
{Scientific data usually comes with errors attatched. At the bottom of each column menu there is an Errors sub-menu or item and this enables you to draw the error-bars on your data.
The available error-bar choices depend on the plot type but include:
Symmetric Error Bars.
- Fixed percent: the error-bar size is plus or minus a percentage of each data value.
- Poisson: the error-bar size is the square root of the magnitude of each data value.
- Column: the error-bar size is given by the data column selected.
Asymmetric Error-Bars.
- the minimum and maximum values are determined by two columns of data from the current data file.
• For XY-Plots:
- The New option disposes of any existing error structure attatched to the selected dataset and will use the currently imported file from which to get the new error information. If the current file has not got the same number of rows as the selected dataset then you may only choose error options which are independent of the current file.
- The Modify option allows you to keep the error structure currently attatched to the selected dataset but to choose one of the alternate options.
• For Histogram Plots:
- There are no options to add error-bars to binned data other than those where the error-bar magnitude is dependent on the number of items in the bin only. There is therefore no need for the New option.
Error-Bar Style:
Error-bars can be either the same color as the symbols or histogram bins to which they are attatched or black. They may be drawn with or without terminating cross-bars and they may have cross-bars of varying length. These options are presented in all Error dialog boxes.}
\title{BINS} {When a histogram is being created or modified the menu-bar contains a Bins entry. This lists options related specifically to histograms such as the number of bins, the range over which to bin and whether to draw the binned data as a histogram or as a set of points optionally joined by lines.}
\subTitle{Number/Other} {Permits you to change the number of bins for either the next histogram to be drawn or for the currently selected one.}
\subTitle{Bin Range} {Presents a dialog which you can use to set the range over which QUAD-Plot will bin the data.
Unlike the Ranges menu which controls what interval of the world coordinate space is visible on the plot, this option allows you to choose the range over which to bin the data. There are 3 choices:
• Full data Range:- all of the data will be included in the binning process.
• Mean ±3 standard deviations:- the mean and standard deviation of the data are determined and the binning range restricted accordingly. This is useful as a quick way of looking at the data but will loose outliers.
• User Range:- you can input any range you like here.}
\subTitle{Draw/Don't Draw}
{The binned data can be drawn either as:
- a histogram,
- a histogram with a symbol at each bin-center,
- a line,
- a set of points,
- a set of points joined by a line.
• If you choose Draw then the bins will be drawn in the line-style selected in the Lines menu. There may or may not be a symbol at each bin-center depending on the Symbols menu.
• If you choose Don't Draw then no bins will be drawn and the binned data will be marked by either lines or symbols or both depending on the state of the Lines and Symbols menus.
}
\title{PLOT} {This menu controls the plot-type and causes a plot to be produced.}
\subTitle{Go!} {This menu instructs the application to Go ahead and add a dataset to the active window using the settings in the other menus}
\subTitle{XY-Plot} {This sets the type of the next plot to represent a set of X, Y pairs selected from the currently imported file.}
\subTitle{Histogram} {This sets the type of the next plot to represent a binned column of data from the currently imported file.}
